Xbasic

EMAIL_CLIENT Function

Syntax

result as C = email_client([C send_to [,C subject [,C message [,C attachments [,C cc [,C bcc [,L modal [,C text_type [,C profile [,C parent_dlg_title [,C msg_id [,L mdi]]]]]]]]]]]])

Arguments

send_toCharacter

One or more comma delimited addresses.

subjectCharacter

The subject of the message.

messageCharacter

The contents of the message.

attachmentsCharacter

A CR-LF or comma-delimited list of filenames to attach to the message.

ccCharacter

One or more comma delimited addresses.

bccCharacter

One or more comma delimited addresses.

modalLogical

Default = .F. (FALSE), .T. = The dialog opens as a modal dialog box, .F. = The dialog opens as modeless dialog box.

text_typeCharacter

Default = "". The options are: "Plain Text" and "HTML"

profileCharacter

Default = "". The email profile to use.

parent_dlg_titleCharacter

Default = "". The title of an Xdialog to display when the send, reply, or forward events occur.

msg_idCharacter

Default = "". A user defined value to identify the message.

mdiLogical

Default = .T. When false, converts the window in a modeless dialog.

Returns

resultCharacter

"Send" = if the Modal flag is set to .T. "" = in all other cases

Description

Display the Alpha Anywhere e-mail client.

Discussion

EMAIL_CLIENT() opens the Alpha Anywhere email client allowing you to compose, edit, and send an email message. All arguments are If any of the arguments is specified, Alpha Anywhere fills in the email client with the default value. In the case of a modal dialog box, if the user closes the email client by pressing the Send button, then Result is set to "send". If the user presses the Cancel button, Result is set to "Cancel". Otherwise, Result is set to a NULL value. If the email client is opened up from a button on a form, the email client will have additional buttons at the bottom of the window:

images/FU_EMAIL_CLIENT.GIF

These buttons allow you to insert fields and expressions into the body of the email message so that your email can include fields from the current record. You can also include conditional statements so that different text is included in the body of the email based on conditions, and you can also include text in the body of the email that is retrieved from saved template.

Example

Open the Alpha Anywhere email client as a modeless dialog and fill in the default email address.

email_client("[email protected]")

Limitations

Desktop applications only.

See Also